home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2005 October / PCWOCT05.iso / Software / FromTheMag / Syn Text Editor 2.1.0.46 / synsetup-2.1.0.46.exe / {app} / asgrep.txt < prev    next >
Text File  |  2004-02-29  |  5KB  |  153 lines
  1. asgrep (Grep Search) Version 2.03
  2. ---------------------------------
  3.  
  4. Copyright ⌐ 2000-2003, Ascher Stefan <stievie@utanet.at>
  5.                        Danail Traichev <neum@developer.bg>
  6.  
  7.  
  8. Contents:
  9. ---------
  10.  
  11.   * License
  12.   * Introduction
  13.   * Commandline Arguments
  14.   * Configuration file
  15.   * Credits
  16.   
  17.  
  18. License:
  19. --------
  20.  
  21. The source of asgrep is distributed under the terms of the Mozilla Public License
  22. Version 1.1 (the "MPL"), see the license.txt file for further informations.
  23.  
  24.  
  25. Introduction:
  26. -------------
  27.  
  28. asgrep is a Find in Files Utility, it supports Regular Expressions, multi Filemask
  29. with Wildcards and searches recoursively all subfolders if requested. Unfortunately
  30. it's not that fast as Borlands Turbo Grep is. Sure, there are sitting lots of
  31. professionals, and I'm just a novice ;-).
  32.  
  33. This is a Console Program, i.e. it has no graphical userinterface, so you can
  34. easily integrate it in your own program, e.g. as syn does.
  35.  
  36. This Program is FREEWARE. You are allowed to use and distribute asgrep for free, 
  37. but you are NOT allowed to sell asgrep for profit.
  38.  
  39. You are using asgrep at your own risk, no responsibility is taken for damages to 
  40. your computer system.
  41.  
  42.  
  43. Commandline Arguments:
  44. ----------------------
  45.  
  46. Usage:
  47.    asgrep [-di <folder(s)>] [-fi <filename(s)>] [-ft <findtext>] [-rt <replacetext>] [-cf <configfile>] [switches]
  48.  
  49.     -ft: use this switch for the text to find.
  50.     -rt:  and -rt for text to replace it with (binary files will be skipped).
  51.     -dt:  or -dt to delete found text (binary files will be skipped).
  52.     -fi: before each filename use the switch -fi.
  53.     -di: if you want to search whole directories use -di. If you have set the r+ switch 
  54.          it will also search all subdirectoreis..
  55.     -ff: for the filefilter use -ff, you can only use one filefilter, you can also 
  56.          combine more filetilters with wildcards, e.g. *.pas;*.dpr.
  57.     -cf: you can also use instead of this parameters a configurationfile, use
  58.          -cf configfile.txt.
  59.     -mc: report match count only.
  60.     -bk: force search/replace in and backup of .BAK files (off by default)
  61.          if option is not set, .bak files are overriden with new backups
  62.     r+ : for recursive search in directories use r+.
  63.     c+ : for casesensitive searche use c+.
  64.     ww+: searching for whole words only.
  65.     re+: use Regular Expression.
  66.     bk-: Don't backup file before replacing Text
  67.     es+: use Escape Sequences for Replace text.
  68.     b+ : for correct search in binary files.
  69.     b- : to skip binary files from search.
  70.     w+ : forces the program to build in some (50 ms) idle time (slower of course).
  71.     d+ : use d+, if you wish to display the line.
  72.     -si:  silent, don't show to much infos.
  73.     -vs:  very silent, implies -si.
  74.     -? :  to show this help use this switch.
  75.     -version: to print out the version use this switch.
  76.  
  77.  
  78. Using a configuration file:
  79. ---------------------------
  80.  
  81. This file is similar to an ini-file:
  82.  
  83.   [main]
  84.   ; The Text to look for
  85.   findtext=yourfindtext
  86.   ; use 1 for match case, otherwise 0.
  87.   matchcase=1
  88.   ; Replace the found match with this text
  89.   replacetext=yourreplacetext
  90.   ; Do replace the found text with replacetext
  91.   doreplace=0
  92.   ; Backup files before replacing
  93.   backup=1
  94.   ; Replace Text contains Escape Sequences
  95.   escapeseq=0
  96.   ; Search also binary files
  97.   checkbinary=0
  98.   ; Skip binary files
  99.   skipbinary=0
  100.   ; Format is either for example "*.htm;*.html" or "*.htm, *.html"
  101.   filefilter=*.*
  102.   ; force the program to wait the specified amount of milliseconds before it
  103.   ; searches a file
  104.   idle=50
  105.   ; for recurse search from the given dirs (search all subfolders) use
  106.   recurse=1
  107.   ; searching for whole words only use
  108.   wholewords=1
  109.   ; use Regular Expression, can't be combined with wholewords
  110.   regexp=1
  111.   ; Shows only the count of found Matches
  112.   matchcount=1
  113.   ; force search/replace and backup in .BAK files (off by default)
  114.   forcebakfiles=1
  115.  
  116.   [files]
  117.   ; All files you want to search.
  118.   count=2
  119.   ; count of the filelist
  120.   1=D:\1stFile.txt
  121.   2=D:\2ndFile.txt
  122.   ; ...
  123.  
  124.   [dirs]
  125.   ; All directories you want to search.
  126.   count=2
  127.   1=1stDir
  128.   2=2ndDir
  129.  
  130. All commandline arguments are overwritten by the configuration file, except files
  131. and dirs, which are added to the list. If an option is not given in the configfile,
  132. but in the commandline, it will use the option from the commandline.
  133.  
  134.  
  135. Matches are written in the consolwindow (StdOut), you can see the filename, the
  136. line- and columnnumber and the linetext.
  137.  
  138.  
  139. Credits:
  140. --------
  141.  
  142.   * The Regular Expression functions are taken from Andrey V. Sorokin's TRegExpr
  143.     Unit (http://anso.da.ru/).
  144.  
  145. ________________________________________________________________________________
  146.  
  147. Best wishes Stefan
  148.  
  149. stievie@utanet.at
  150. http://web.utanet.at/ascherst/
  151.  
  152. $Id: readme.txt,v 1.2.2.8 2004/02/29 03:23:23 neum Exp $
  153.